package com.dms.modules.user.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.dms.modules.user.entity.Region;
import com.dms.modules.user.vo.RegionTreeVO;

import java.util.List;

public interface RegionService extends IService<Region> {
    
    /**
     * 获取省份列表
     * @return 省份列表
     */
    List<Region> getProvinces();
    
    /**
     * 获取城市列表
     * @param provinceCode 省份编码
     * @return 城市列表
     */
    List<Region> getCities(String provinceCode);
    
    /**
     * 获取区县列表
     * @param cityCode 城市编码
     * @return 区县列表
     */
    List<Region> getDistricts(String cityCode);
    
    /**
     * 根据编码获取区域信息
     * @param code 区域编码
     * @return 区域信息
     */
    Region getByCode(String code);

    /**
     * 获取完整的地区层级树
     * @return 地区层级树
     */
    List<RegionTreeVO> getRegionTree();
} 